SmartAgent Version 9.12.3

发布日期：2026 年 3 月 25 日

版本概述

SmartAgent 9.12.3 聚焦于 进程采集白名单及父子进程指标拆分策略，并包含 DotnetAgent 6.15.4、GoAgent 5.0.1 升级，JavaAgent 9.12.2 稳定性修复，以及 镜像、dockerhelper、安装参数优化。

• ✨ 进程监控增强：支持进程采集白名单；白名单进程无条件采集且父子进程指标独立采集；非白名单进程子进程指标合并到父进程

• ✨ DotnetAgent 6.15.4：适配 nms-ActiveMQ/AMQP 接口；修复 GAC 加载失败；修复 GCC4.8-regex 缺陷可能导致崩溃

• ✨ GoAgent 5.0.1：修复使用非 MySQL 数据库时可能导致崩溃的问题

• ✨ JavaAgent 9.12.2：优化异步线程错误标识一致性；优化 JDK 17 适配；修复探针 uid 变更时未重新注册问题

• 🔧 通用增强：镜像 1.1.4；dockerhelper 死循环检测优化及 mount 路径合法性检查；安装参数优化

升级建议

• 所有用户建议升级以获得进程采集灵活性及各探针稳定性改进；
• 使用 DotnetAgent、GoAgent 或 JavaAgent 的用户应优先升级以修复已知崩溃及注册问题。

---

Linux x86_64 系统

支持平台版本

• One 平台：V2.2.2 及以上版本

集成探针版本

• JavaAgent: 9.12.2
• DotnetAgent：6.15.4
• PHPAgent：8.5.0
• PythonAgent：8.6.0
• NodejsAgent：7.1.1
• NginxAgent：3.8.4
• ApacheAgent：3.4.0
• SDKAgent：5.14.1
• GoAgent：5.0.1
• logsAgent：2.3.0

新增功能

1. 支持进程采集白名单及父子进程指标拆分策略：

   • a. 白名单进程无条件采集指标
   • b. 白名单进程父子进程指标独立采集
   • c. 非白名单进程子进程指标合并到父进程

   在 machine.yml 中新增以下配置：

# 进程指标采集配置
processMonitor:

  # 触发阈值配置（仅对非识别应用进程生效）
  #
  # Agent 以 1 分钟为统计周期，在内部采用固定的滑动窗口策略：
  #   - 最近 5 个 1 分钟区间
  #   - 至少 3 个区间满足条件
  #
  # 在任意一个 1 分钟区间内，只要满足以下任一条件，
  # 即认为该区间被触发：
  #   - 平均 CPU 使用率超过 cpuThreshold
  #   - 最大内存使用率超过 memoryThreshold
  #
  # 当触发区间数量达到内部判定条件时，
  # 该进程才会被采集并上报。
  triggerThresholds:
    cpuThreshold: 5        # Avg(CPU)，单位：百分比，默认值：5
    memoryThreshold: 5     # Max(Memory)，单位：百分比，默认值：5

  # 进程强制采集白名单（按可执行文件名或进程名称匹配）
  #
  # 行为说明：
  # 1. 命中 whiteList 的进程：
  #    - 无条件采集（不受 CPU / 内存阈值限制）
  #    - 不对子进程指标进行聚合
  #
  # 2. 未命中 whiteList 的进程：
  #    - 仅在满足触发阈值策略后才采集
  #    - 子进程的 CPU / 内存等指标将聚合到父进程
  #
  # 匹配规则：
  # - 使用进程可执行文件名或进程名称
  # - 不包含路径
  whiteList:
  #  - auditd

功能优化与修复

1. JavaAgent 升级至 9.12.2

功能优化

• 优化异步线程场景错误请求和调用链错误标识的一致性；
• 优化 JDK 17 适配，规避 Class.getGenericSignature0() 异常。

修复 Bug

• 修复偶发情况下探针 uid 变更时未重新进行注册（影响范围：JavaAgent 8.0.0～9.12.1，对应 SmartAgent 6.0.0～9.12.1）。

2. DotnetAgent 升级至 6.15.4

功能优化

• 适配 nms-ActiveMQ/AMQP 接口（支持版本：Apache.NMS.ActiveMQ-2.2.0，.NET Core 2.0/2.1/2.2/3.0/3.1、.NET5.0/6.0/7.0/8.0；Apache.NMS.AMQP-2.4.0，.NET Core 2.0/2.1/2.2/3.0/3.1、.NET5.0/6.0/7.0/8.0）；
• 修复引入第三方 WebApi 库引起安装时 GAC 加载失败。

修复 Bug

• 修复 netcore 版本设置引入的 GCC4.8-regex 自身缺陷可能导致崩溃（影响范围：DotnetAgent 6.15.2、6.15.3，对应 SmartAgent 9.11.0～9.12.2）。

3. GoAgent 升级至 5.0.1

修复 Bug

• 修复在使用非 MySQL 数据库时可能导致崩溃的问题（影响范围：GoAgent 5.0.0，对应 SmartAgent 9.11.0～9.12.2）。

4. SmartAgent 镜像更新至 1.1.4

• --set-conf 和 --reset-conf 配置 YAML 数组字段时，每个元素单独一行。

5. 安装参数优化

• --set-conf 和 --reset-conf 配置 YAML 数组字段时，每个元素单独一行。

6. dockerhelper 死循环检测优化

• 调高默认检查阈值，降低误判风险。

7. dockerhelper 优化

• 检查 mount 目标路径是否合法，不合法则跳过；
• 增加重入注入检查。

---

Linux ARM64 系统

支持平台版本

• One 平台：V2.2.2 及以上版本

集成探针版本

• JavaAgent：9.12.2
• DotnetAgent：6.15.4
• PHPAgent：8.5.0
• PythonAgent：8.6.0
• NginxAgent：3.8.4
• SDKAgent：5.14.1
• GoAgent：5.0.1
• logsAgent：2.3.0

功能优化与修复

平台说明

本平台的功能更新与 Linux x86_64 系统基本一致，主要差异为探针支持范围。具体包括：

新增功能

• 进程采集白名单及父子进程指标拆分策略（同 Linux x86_64）

功能优化与修复

• 同 Linux x86_64（含 JavaAgent、DotnetAgent、GoAgent、镜像、安装参数、dockerhelper 更新）

注意事项

• ARM64 平台暂不支持 NodejsAgent、ApacheAgent

---

Windows x86_64 平台

支持平台版本

• One 平台：V2.2.2 及以上版本

集成探针版本

• JavaAgent：9.12.2
• DotnetAgent：6.15.4

新增功能

1. 支持进程采集白名单及父子进程指标拆分策略（同 Linux；参见上方配置说明）。

功能优化与修复

1. JavaAgent 升级至 9.12.2

（内容同 Linux 平台）

2. DotnetAgent 升级至 6.15.4

功能优化

• 适配 nms-ActiveMQ/AMQP 接口（支持版本：Apache.NMS.ActiveMQ-1.7.1/2.2.0，.Net Framework 4.0+、.NET Core 2.0/2.1/2.2/3.0/3.1、.NET5.0/6.0/7.0/8.0；Apache.NMS.AMQP-2.4.0，.Net Framework 4.6.1+、.NET Core 2.0/2.1/2.2/3.0/3.1、.NET5.0/6.0/7.0/8.0）；
• 修复引入第三方 WebApi 库引起安装时 GAC 加载失败。

修复 Bug

• 修复 netcore 版本设置引入的 GCC4.8-regex 自身缺陷可能导致崩溃（影响范围：DotnetAgent 6.15.2、6.15.3，对应 SmartAgent 9.11.0～9.12.2）。

---

兼容性说明

平台兼容性

操作系统	支持架构	最低 One 版本
Linux	x86_64	V2.2.2
Linux	ARM64	V2.2.2
Windows	x86_64	V2.2.2